; Text file for use by QWIKMATH.EXE. Place that program and this file in the
; in the same directory, go to that directory, then type QMHELP. (Or, after
; proper installation, simply type AEHELP.)
;
; Except as specified "User-Added Information," below, no alterations may be 
; made to this file. Doing so violates the copyright and may make this file 
; unusable. Use well, and enjoy.
;
17 March 1990
6
PRINTOK
TITLE:     QWIKMATH USERS MANUAL
                                 USERS  MANUAL

                                   -- for --


                                                                        [tm]
  ****  **         ** ******** **   ** ****   ****  *****  ******** **    **
 **  **  **   *   **     **    **  **  ** ** ** ** **   **    **    **    **
**  * **  ** *** **      **    *****   **  ***  ** *******    **    ********
 **  **    *** ***       **    **  **  **   *   ** **   **    **    **    **
  **** *    *   *     ******** **   ** **       ** **   **    **    **    **

                   THE COMPLETE PROGRAMMING CALCULATOR [tm]



                        Copyright (c) 1990, J. W. Olsen
                              All Rights Reserved
                          Advocate Enterprises, Ltd.
                                    Chicago
~ (Menu)
           ====================  Run-Time Menu  ===================
           =                                                      =
           =  Q - QUIT Program                                    =
           =  A - ALL SECTIONS of File                            =
           =                                                      =
           =  1 - Becoming Acquainted with & Installing QWIKMATH  =
           =  2 - Using QWIKMATH                                  =
           =  3 - Error Conditions & Unusual Occurrences          =
           =  4 - (User-Added Information)                        =
           =  5 - License Agreement, Credits & Disclaimer         =
           =                                                      =
           ========================================================
~ (Section 1)
              << BECOMING ACQUAINTED WITH & INSTALLING QWIKMATH >>

    QWIKMATH  is  the  most comprehensive programmers'  calculator  on  the 
    market today--providing extensive features while being easy to use.  It 
    offers:
     *    A complete range of arithmetic and bitwise operators.
     *    Values may be entered in binary, octal, decimal or hexadecimal,
          with results always displayed in all radices (as well as their
          ASCII or extended scan code equivalents, where applicable).
     *    A special "Character" value-entry mode permits you to press any
          ASCII or extended scan code key(s) and instantly see its value
          in all of the above radices, plus the visual character or symbol
          displayed when that value is used for screen output.
     *    The ability to perform calculations in 32-bit, 16-bit and 8-bit
          values.
     *    A 16-level "undo" feature to escape erroneous entries or freely
          experiment in a "what if" session without losing the results of
          prior operations.
     *    The ability to freely combine and move between all of the above
          conditions at any time.
     *    Context-sensitive, built-in help screens.
     *    Executable as a stand-alone or "stay-resident" program.
     *    After installation, results of the most recent operation and user
          configuration preferences are automatically saved. They may be 
          acted upon, discarded, or altered at will.
          
    This product is currently available for IBM-compatible computers with a 
    minimum  configuration of one disk drive (hard disk or floppy) and  64K 
    memory. PC-DOS or MS-DOS v. 2.0 (or higher) is  required. Inquire about 
    QWIKMATH  for  other environments. Contact information appears  in  the 
    last section.

    By  use of this product, you agree to the terms and conditions  of  the 
    License Agreement in the last section of this manual.

    QWIKMATH  is easy to use, but please browse the complete manual  before 
    using  to avoid surprises. QWIKMATH should be installed AND  configured 
    for your system to function to maximum potential.

    INSTALLATION

    Please ensure you received all files:
    1ST-TIME.COM    Advises how to get started. READ THIS FIRST.
    QM-SHARE.EXE    Main calculator program (with shareware notice)
    or QWIKMATH.EXE Main calculator program (registered copy)
    QWIKMATH.FOR    One-paragraph summary (for BBS use--optional)
    QWIKMATH.HIS    History of revisions
    QWIKMATH.HLP    Text file you're now reading
    QMHELP.EXE      Displays file you're reading to screen or printer
    QMREADME.COM    Latest information, updates and introduction. (This is
                    an optional file. If present, READ BEFORE INSTALLING
                    THIS PRODUCT IF YOU HAVE NOT YET DONE SO. It may
                    contain important updates to this HELP file.)
    AEHELP.EXE      Access help files for ALL Advocate Enterprises products
    AEORDER.EXE     Display product descriptions and prints licensing form
    AEORDER.HLP     Text file for AEORDER.EXE
    AHDINSTL.COM    Fully-automated hard-disk installation program

    If new to ordering software, note that distribution disks don't contain 
    "operating system files" because of the exceptional costs we would have 
    to  pass along. So to get started, you must make copies of these  files 
    before using them. Also, you'll want to install the above files to best 
    advantage. It's quick and easy. . . .

                           If This Is an Upgrade...

    Before following the installation instructions below, be SURE to  first 
    COPY all QWIKMATH files from your Advocate directory to a back-up disk. 
    Some  of  those  files may not be compatible with the  new  files,  and 
    installing  the new files may OVERWRITE (i.e., erase and replace)  the 
    old ones. You may want to read the new QWIKMATH.HIS file for a synopsis 
    of  enhancements since your prior version. Doing so will suggest  which 
    topics of this manual will best assist you to learn about new features.

                               Hard-Disk Systems

    You  may either use the accompanying AHDINSTL.COM installation  program 
    (STRONGLY  recommend!) or manually install all files. Each  is  covered 
    separately below.

    AUTOMATIC  INSTALLATION: AHDINSTL.COM will do it all for you--copy  all 
    files  to  your hard disk, ensure they're accessible from  ANYWHERE  on 
    your system and inform your operating system about how to use  Advocate 
    Enterprises  products  to maximum potential. All YOU must  know  before 
    running  AHDINSTL are the drive letters of the floppy drive  containing 
    your new files and the hard drive from which you "boot" (start up) your 
    system  each  day. (These are almost always A:  and  C:,  respectively, 
    which  are defaults AHDINSTL uses unless you change them.) Also, it  is 
    presumed  your  system already knows how to access its  COMMAND.COM,  a 
    basic operating system program whose services AHDINSTL accesses.

    The  following text details the tasks AHDINSTL performs. If you  aren't 
    technically  oriented, you may want to simply skip this discussion  and 
    jump  to the "All Systems" heading later in this section. Knowledge  of 
    the  following  isn't  essential  except  in  the  unlikely  event  you 
    experience installation difficulty.

          AHDINSTL performs these steps during installation: 
          1)  It finds (or if necessary creates) a directory called  AD_ENT 
    off the root directory of the drive you indicate as your "boot" drive.
          2) Your AUTOEXEC.BAT file (used by the operating system to set up 
    your environment each time you start your computer) is inspected for  a 
    "PATH"  command. If found, the new AD_ENT directory is appended to  it. 
    If no PATH command (or no AUTOEXEC.BAT file) is found, one is created. 
          3)  If  your  AUTOEXEC.BAT file  contains  no  previous  Advocate 
    Enterprises "SET" command, one is added. (Advocate products use this to 
    determine their "home directory.")
          4)  If  you  had  a  prior AUTOEXEC.BAT  file,  it  is  saved  as 
    AUTOEXEC.BAK as a precaution. The only time you're ever likely to  need 
    it  is  if you had too many or very long prior SET  commands.  In  that 
    case, the operating system will advise next time you start up that  you 
    are "Out of environment space." (AHDINSTL uses VERY little  environment 
    block  space. So if you've reached your current environment limit  now, 
    you'll  soon run into it with another product anyway.) The solution  is 
    easy.  See the discussion of the CONFIG.SYS file's "SHELL"  command  in 
    your  operating  system  manual. Contact us as indicated  in  the  last 
    section if you need further help.
          5)  You  will be offered the chance to have  AHDINSTL  "coldboot" 
    (restart)  your  computer  when done. This  immediately  activates  the 
    changes  the  program makes for you; otherwise,  the  operating  system 
    won't  know  about them until the next time you restart  the  computer. 
    This is provided as a convenience for you. IMPORTANT: DON'T coldboot if 
    you're   currently  running  other  applications  in  the   background. 
    (Coldbooting   is  equivalent  to  telling  your  computer  to   forget 
    everything  it's doing and start over just as if you had turned  it  on 
    for  the  day.) IF YOU DON'T HAVE THE INSTALLER COLDBOOT  YOUR  SYSTEM, 
    QWIKMATH WILL NOT BE FULLY OPERATIONAL UNTIL THE NEXT TIME YOU TURN  ON 
    YOUR COMPUTER. Now, see "All Systems," below.

    MANUAL INSTALLATION: You may simply copy all files into a directory  of 
    your choice with a favorite copy program. Just ensure that directory is 
    on  your  PATH. Then, add a "SET" command EARLY  in  your  AUTOEXEC.BAT 
    file. We assume if you're doing this manually you're familiar with  how 
    to properly edit that file. The command to add begins with:
    SET ADENT=
    and is followed IMMEDIATELY by the drive AND directory containing  your 
    new  product.  Note that spacing, etc., MUST be in  exactly  the  above 
    format and maximum length of the drive and directory is 63  characters. 
    The operating system treats them literally. In particular, ensure there 
    are no trailing spaces after the drive and directory. Example:
    SET ADENT=C:\UTILITIES

    IMPORTANT:  Your operating system won't offer the benefits of this  new 
    command until the NEXT time you restart your computer.

    NOTE: If you already have a SET ADENT command in your AUTOEXEC.BAT file 
    for  another of our products, you cannot add a second. You simply  must 
    COPY all of your new files to the current Advocate directory.

                           Floppy-Disk-Only Systems 

    Format a blank disk and add your operating system as usual. This  means 
    either  formatting  the  blank disk with  the  "/S"  ("sysgen")  option 
    (detailed in your operating system manual), or first formatting it  and 
    then using your operating system's SYSGEN program. In either case, next 
    copy COMMAND.COM and your favorite file copying utility to the disk and 
    place it in drive A:. Place the new distribution disk in drive B:. 
          Now,  copy files from B: to A:. (If you only have one drive,  the 
    operating  system will treat it as both drive A: and drive  B:.  Simply 
    place  the  distribution disk in the drive and tell your  file  copying 
    utility  to copy from B: to A:.) The normal command to copy and  verify 
    all files is:
    COPY B:*.* A: /V

    IMPORTANT:  After  copying  the  files,  see  the  discussion  on   the 
    AUTOEXEC.BAT  "SET"  command under "MANUAL  INSTALLATION,"  above.  The 
    command you'll probably want to add to your AUTOEXEC.BAT file is one of 
    the  following,  assuming you will keep your Advocate products  in  the 
    root directory:
    SET ADENT=A:\
    SET ADENT=B:\

    ANOTHER  IMPORTANT  NOTE: Assuming you've entered the  SET  command  to 
    maximize  QWIKMATH's  benefits,  the program must have  access  to  the 
    Advocate directory whenever you exit the program (regardless of whether 
    you  exit as a TSR "stay-resident" program or normally) so it can  save 
    data.  If you haven't added a SET command, no attempt will be  made  to 
    save data between sessions.
    
                                  All Systems

    Use  ONLY the working copies you create. Thwart Murphy's Law by  safely 
    storing the originals--just in case.

    SOME ADDITIONAL THOUGHTS

    If you have received a shareware copy of this product, substitute  "QM-
    SHARE" for references to the program name of "QWIKMATH" throughout this 
    manual.  We suggest that you not rename the shareware version so  that, 
    after receipt of a registered copy, the former won't be overwritten and 
    you  thus will have a copy to pass along to friends and associates  who 
    also might benefit.

    You have received at no charge a special utility which takes  advantage 
    of  some  features  of your operating  system.  AEHELP.EXE  provides  a 
    convenient,  single  access  point to the main  help  and  registration 
    information  for ALL Advocate products properly installed according  to 
    the   above  instructions.  (If  you  have  other,   earlier   Advocate 
    Enterprises products, you may maximize their use simply by placing them 
    in the same, newly created Advocate directory.)

    We've made a conscientious effort to accommodate a broad range of needs 
    which  we've  identified and which have been suggested  by  users.  But 
    enhancements  are  always  possible. We'll work with you  if  you  have 
    ideas,  difficulties--whatever.  And,  we'll  supply  a   complimentary 
    upgrade containing any of your suggestions we implement. This  benefits 
    you  and others. Contact information appears in the last  section.  For 
    now, enjoy your new productivity tool!
~ (Section 2)
                             << USING QWIKMATH >>

    We'll describe each Main Menu operation below. While it isn't essential 
    that  you understand all of them before you start, it IS  important  to 
    become familiar with a few concepts discussed throughout this  section. 
    We  strongly  urge that you at least skim the complete  section  before 
    using the program to avoid unexpected results.

    Note:  It is beyond the scope of this software user's manual  to  teach 
    programming math. While we will offer limited information as warranted, 
    we cannot, for example, detail the purposes of bitwise shifts, rotates, 
    twos complements and the like. QWIKMATH is a tool for programmers,  not 
    an  instruction  book in programming itself.  This  manual  presupposes 
    users  are  familiar with basic programming math or  will  obtain  such 
    knowledge from a reference book dedicated to that purpose.

    As  a general comment, in almost all cases pressing the ESC key  aborts 
    the  current  operation  with  no action  taken.  An  exception  is  in 
    QWIKMATH's  unique Character data entry mode (discussed  below),  where 
    ESC is a legal value.

    USAGE OVERVIEW

    The main screen is composed of two distinct parts. At its bottom is the 
    Dialogue  Box  in  which QWIKMATH offers  choices,  displays  help  and 
    advises  of  errors. Three pieces of important information  are  always 
    displayed  on the first line of the Dialogue Box. These are, from  left 
    to  right: the currently active operation (or "Select Operation" if  no 
    operation is active); Storage Class; and Character Mode. The latter two 
    settings are essential to understand and are discussed below.

    Above  the Dialogue Box is the main Data Display Area. In turn, it  has 
    three  subparts.  For most operations, you will be entering  a  numeric 
    value  in  any one of the boxes under Entry Value. In  all  cases,  the 
    effects of the most recent numeric operation are displayed in ALL boxes 
    under Current Results. The Format column simply identifies the  purpose 
    of  each  row.  (Also--by  a  highlighted  character  in  each  row--it 
    indicates  what  character may be pressed to select  the  corresponding 
    Entry Value box for data entry.)

    FORMATS

    Most  users  will  be  acquainted  with  binary,  octal,  decimal   and 
    hexadecimal   ("hex")  Formats--or  representations--of  numbers.   For 
    example,  the decimal number 100 is equivalent to 01100100  in  binary, 
    144 in octal and 64 in hex. (If you didn't know that and wanted to find 
    out, you would select decimal format, enter 100 and observe  QWIKMATH's 
    display of all other equivalent values.)

    To  these  four  radices, QWIKMATH adds  a  "Character"  format,  which 
    displays  what  the Current Results looks like when  displayed  to  the 
    screen. In the above example "d" would appear under Current Results  on 
    the  Character  format  row.  (Note: For  many  values,  the  Character 
    representation is a graphic symbol. In a couple of cases, it is a BLANK 
    character, which QWIKMATH represents by displaying the term  "[blank]". 
    For  values  above 255 (decimal), for which there  are  no  displayable 
    Character  equivalents, QWIKMATH displays "[Extended scan code]" if  it 
    applies (see below), otherwise "[Inapplicable]".)

    CONFIGURING QWIKMATH TO YOUR PREFERENCES

    QWIKMATH  is  designed to perform its various operations  in  differing 
    ways depending upon your current needs. So when you invoke the  program 
    you will need to select certain preferences. (If you have installed the 
    product  as recommended in Section 1, your last set of preferences  and 
    the  Current Results of your most recent operation are stored  to  disk 
    when  you  exit  QWIKMATH and recalled the next  time  you  invoke  the 
    program.)

    IMPORTANT:  The  first  time you invoke  QWIKMATH,  use  the  Utilities 
    function to select your preferred Storage Class and Character Mode. You 
    also  may want to alter the default TSR "hotkey" used to return to  the 
    program  if you exit in TSR mode. The current hotkey is displayed  when 
    you select the Utilities function. Each of these features is  discussed 
    below.

    If  you  haven't installed QWIKMATH as recommended, you  will  want  to 
    perform  the  above  procedure  each  time  you  invoke  the   program. 
    Otherwise,  in future uses of QWIKMATH you need only double-check  that 
    the current Storage Class and Character Mode are to your liking.

    STORAGE CLASS

    As  you  probably know, programming math deals with values of  a  given 
    size. QWIKMATH performs calculations for all of the three common  sizes 
    of values--8-bit (referred to as a byte), 16-bit (data word) and 32-bit 
    (double  word). All have a minimum value of zero. A byte has a  maximum 
    value  of  255 (decimal). A word has a maximum value of 65,535.  And  a 
    double word has a maximum value of 4,294,967,295.

    For  many operations, you might simply want to leave Storage Class  set 
    to  32 bits. (E.g., adding 1F hex and 2A hex produces the same  results 
    regardless  of storage class--disregarding the number of  insignificant 
    leading  zeros displayed.) For other operations, the storage  class  is 
    inherently  critical.  (E.g.,  rotating the bits of  a  value  produces 
    categorically different results for each class.)

    Storage  Class  may be freely changed at any time  from  the  Utilities 
    menu.  Upon changing it, the high-order byte(s) of the Current  Results 
    value will immediately reflect the change. For example, if the  Current 
    Results  has a value of 0FF0 (hex) in 16-bit class, changing the  class 
    to 32 bits would result in a display of 00000FF0. Changing from  either 
    of these conditions to a 8-bit class would produce a display of F0. (As 
    you  will  see,  if  you  make such a change  in  error,  you  can  use 
    QWIKMATH's Undo operation to return to the former value and class.)

    CHARACTER MODE

    QWIKMATH  provides  a  service  not  normally  found  in   programmer's 
    calculators  through its Character Format. The Character  Mode  setting 
    instructs  QWIKMATH  about how you want that format  treated.  The  two 
    options are ASCII and "extended scan code" modes. (As you may know,  in 
    the  PC-DOS/MS-DOS world, most keys and many combinations of keys  have 
    unique extended scan codes. A quick look at any ASCII table will reveal 
    that  many keys--e.g., function keys--have no ASCII  equivalents.  Scan 
    code values are essential to sophisticated programming.)

    If  you select ASCII mode and enter a new value in Character Format  by 
    pressing  the capital letter "A", Current Results would display an  "A" 
    in the Character row, 65 in the Decimal row, etc. On the other hand, in 
    extended  scan code mode, pressing the same key on the  Character  line 
    would  cause  the  equivalent scan code  value  to  be  displayed--7745 
    decimal,  etc.  As  this  has  no  displayable  screen  character,  the 
    Character row under Current Results would simply advise "[Extended scan 
    code]".

    Because  some  keys and combinations of keys have no  ASCII  equivalent 
    (such as the Home key), QWIKMATH will beep in protest if you attempt to 
    press them while in ASCII mode.

    ENTRY OF NUMERIC VALUES

    All  math  and most bitwise operations involve an entry  of  a  numeric 
    value.  When a value is expected, a blinking cursor will appear in  one 
    of the Entry Value boxes in the top portion of the screen. For example, 
    it may appear in the box on the row for Decimal Format. If you want  to 
    enter  a  value in that radix, you may simply do so. If you  prefer  to 
    enter the value in a different radix, you may move the cursor with  the 
    keys on the numeric keypad (arrow keys, Home, End, PgUp, PgDn), or  you 
    may  press one of the highlighted characters in the Format column  ("H" 
    for  hexadecimal,  etc.), then enter the value. (NOTE: For  the  cursor 
    control  keys on the numeric keypad to operate properly, be  sure  your 
    NumLock key and light aren't active!)

    As  you may know, "B," "C" and "D" (highlighted characters  with  which 
    you may select Binary, Character and Decimal Formats, respectively) are 
    legal values in Hexadecimal and Character mode. If you need to use  one 
    of  these  characters  to begin Character or  Hexadecimal  format  data 
    entry,  first  press the ENTER key, then enter your  value.  Using  the 
    ENTER key alerts QWIKMATH to treat the next character literally, not as 
    a command to change data entry format.

    DISCUSSION OF INDIVIDUAL OPERATIONS

    Like  the  Main Menu itself, we will divide discussion of  the  various 
    QWIKMATH  operations  into  subsections  of  Primary  Operations,  Math 
    Operations  and Bitwise Operations. (The parenthetical  information  in 
    each heading indicates the key which invokes the operation. E.g.,  "F1" 
    means function key one. "Shift F1" means hold down either shift key and 
    simultaneously press function key one.)

                              Primary Operations

    HELP (F1): Provides a quick, general introduction to QWIKMATH.  Various 
    other operations provide more detailed, context-sensitive help screens.

    ENTER NEW (F2): Use to enter a new value in any Format. Results will be
    displayed  in all Formats. THIS FUNCTION CLEARS THE CALCULATOR  OF  THE 
    PRIOR  CURRENT RESULTS. (See Undo operation under Utilities, below,  if 
    you inadvertently clear a value you want to retain.)

    UTILITIES (F8): This is the only Main Menu option leading to a submenu. 
    That submenu offers the following features:
          UTILITIES HELP (F1): Utilities-specific help screen.
          UNDO LAST OPERATION (F2): This function immediately reverses  the 
    effects  of the most recent numeric operation or most recent change  in 
    Storage  Class or Character Mode, whichever occurred last. By  repeated 
    use  of this function, you may "undo" up to 16 previous  operations  or 
    changes.  This  function is handy not only to rectify errors  but  also 
    provides  the  opportunity to freely try complex  "what  if"  scenarios 
    without losing interim steps.
          CHANGE STORAGE CLASS (F3): See detailed discussion, above.
          CHANGE CHARACTER MODE (F4): See detailed discussion,above.
          CHANGE  TSR HOTKEY FROM... (F5): Permits you to change  the  keys 
    used to return to QWIKMATH from another program or the operating system 
    if  you  exit  in  TSR mode. (See discussion on  TSR  mode,  below,  if 
    unfamiliar  with  "stay-resident"  programs.)  Note  that  the  current 
    "hotkey" is displayed on this line. It also is displayed if you attempt 
    to  execute a second copy of QWIKMATH while one is currently in  memory 
    as  a TSR. Note too that the hotkey may be changed "on the  fly."  That 
    is,  if you later want to invoke a program while QWIKMATH is a TSR  but 
    the  latter  program requires use of your  currently-selected  QWIKMATH 
    hotkey, you may use the hotkey to re-enter QWIKMATH, alter the  hotkey, 
    then  exit and use the other program. If you installed our  product  as 
    recommended,  the  last-selected hotkey is permanently  stored  between 
    sessions along with Storage Class, etc.

    TSR  EXIT  (F9)  and QUIT (F10): Two methods to  leave  QWIKMATH.  (See 
    discussion on TSR functioning, below.)

                                Math Operations

    (F3  through F7): All Math operations solicit a Entry Value  from  you, 
    then perform it on the Current Results value, if possible.  (Attempting 
    to  divide  by zero, results which would be less than zero  or  greater 
    than the maximum value for the currently selected Storage Class and the 
    like will cause an error message to be displayed. Current Results  will 
    be unaffected by the erroneous attempt.)

                              Bitwise Operations

     (Shift  F1  through  Shift F9): Most  Bitwise  operations,  like  Math 
    operations,  solicit a value, then perform the selected operation  upon 
    Current  Results. (Again, if the operation is illegal, no action  other 
    than  display  of an error message will occur.) As you  probably  know, 
    some  Bitwise  operations (e.g., rotates and shifts) involve  only  one 
    value.  In  such  cases,  the  operation  is  performed  directly   and 
    immediately  upon  the Current Results values.  For  example,  pressing 
    Shift F9 (Rotate Right) with a Current Results binary value of 10000001 
    would result in 11000000. Pressing it again would result in 01100000.

    DISCUSSION ON TSR ("STAY RESIDENT") FEATURES

    QWIKMATH  may  be retained in memory  and  instantaneously  reactivated 
    through your selected TSR hotkey. You may do so in either of two  ways. 
    You may simply use the TSR Exit. Or, you may type QWIKMATH /T from  the 
    operating  system  prompt to load the program into memory  as  a  stay-
    resident  program and immediately exit. (This command  is  particularly 
    convenient if you want to load it every time you load your compiler  or 
    assembler  by placing it and the name of the compiler/assembler into  a 
    batch  file.) Thereafter, using the hotkey will return you to  QWIKMATH 
    under  exactly the values and configuration settings as when  you  last 
    exited it.

    Once  loaded as a TSR, exiting the program thereafter either  with  the 
    TSR Exit or Quit function retains QWIKMATH in memory. And, once loaded, 
    during your current session at the computer you must use the hotkey  to 
    activate  QWIKMATH, not type its name at the  operating-system  prompt. 
    (Attempts  to do the latter will result in display of the hotkey and  a 
    reminder of how to activate the copy of the program already in memory.)

    There  are a couple of conditions under which it is temporarily  unsafe 
    to  re-enter  a TSR. One such condition is if you're  in  a  foreground 
    program  which is in a graphic rather than text display mode.  Re-entry 
    under  such  a condition would confuse the  foreground's  display  upon 
    return  from  QWIKMATH.  Secondly,  it is  unwise  to  suspend  certain 
    operating  system functions (such as disk accesses) to re-enter a  TSR. 
    Under  any of these circumstances, QWIKMATH simply executes a  "warble" 
    sound  and returns you to the foreground application.  Normally,  using 
    the  hotkey  again a moment later will gain access to QWIKMATH  in  all 
    cases  except  an active graphic display  mode--an  extremely  unlikely 
    situation  in  which anyone ever is likely to be programming  and  thus 
    have need of a programming calculator. (If you do find yourself in such 
    circumstances, simply switch to text mode, then use QWIKMATH's  hotkey. 
    Graphic-display applications often permit switching to text mode.  They 
    may   also  have  a  "DOS  gateway"  function,  which  generally   will 
    automatically  switch  to text mode. As a last-case scenario,  you  may 
    exit  the  foreground application, use the hotkey,  then  reinvoke  the 
    application program.)

    If  you haven't loaded QWIKMATH as a TSR during the  current  computing 
    session,  leaving  with the Quit function exits without  retaining  the 
    program  in memory, freeing the space it had occupied for use by  other 
    programs.  It is not possible to do so even with Quit if  QWIKMATH  has 
    previously been loaded in memory during the current computing session. 
~ (Section 3)
                <<  ERROR CONDITIONS & UNUSUAL OCCURRENCES  >>

    Unlikely  though  it  is  that  you'll  encounter  them,  this  section 
    discusses  errors  and other potential problems. Registered  users  who 
    experience  difficulties  they can't solve are  encouraged  to  contact 
    Advocate Enterprises. 

    INABILITY TO RE-ENTER A LOADED "STAY-RESIDENT" PROGRAM

    It  is conceivable that--once loaded into memory as a TSR--you  may  be 
    unable  to access the program. QWIKMATH protects the integrity of  your 
    operating  environment if it senses some external condition  making  it 
    unsafe or unwise to re-enter it as a TSR. If it does so, it will advise 
    by issuing a "warble" sound identical to that the program uses when you 
    press an invalid key while within QWIKMATH itself. (You'll likely never 
    experience this, but you should recognize it if it occurs.)  Generally, 
    it  will  be  safe to re-enter a moment later. Simply  try  the  hotkey 
    again.  In the rare instances when this doesn't provide access,  please 
    see discussion on TSRs toward the end of Section 2.

    If using the hotkey doesn't return you to QWIKMATH after loading it  as 
    a  TSR  and the program's distinctive warble is NOT heard,  some  other 
    program has corrupted your operating environment or improperly  altered 
    the interrupt handlers (a technical subject) that QWIKMATH, like  other 
    TSRs, uses to detect its hotkey. This isn't likely to occur, but if  it 
    should happen it may well mean the program which caused the problem has 
    left  your  operating  environment in an unstable  condition.  In  such 
    cases,  we urge you to 1) save any work in progress by other  programs; 
    2) turn off your computer; and 3) ask your resident computer expert  or 
    your  computer  consultant to determine which external program  may  be 
    creating  the  problem.  (Generally, it will be a  program  used  AFTER 
    loading QWIKMATH as a TSR, but not necessarily so. Making a list of all 
    programs  used  during  your  current computing  session  will  aid  in 
    isolating the problem.)

    CORRUPTED INFORMATION ON QWIKMATH'S SCREEN

    If  QWIKMATH's  configuration  file  has  been  corrupted  without  the 
    program's  knowledge (i.e., between the time you last used the  program 
    and  when  you invoked it today), random characters may appear  on  the 
    screen,  generally in the Dialogue Box. If this should occur,  use  the 
    Quit function (not TSR Exit), then follow the instructions to  manually 
    delete  the  file  and reconstruct it  outlined  under  "Error  writing 
    configuration file," below.

    ERROR MESSAGES

                       Error writing configuration file
    The operating system reported it failed to create or successfully write 
    the QWIKMATH configuration file. QWIKMATH will ask the operating system 
    to  delete  the corrupted file. You should check if this  deletion  was 
    successful. If not, manually delete the file named QWIKMATH.nnn  (where 
    "nnn" is a 3-digit number) from your Advocate directory. Otherwise, the 
    program  may  behave strangely the next time you use it. (It  will  not 
    harm anything, but you may find the program unusable until you  correct 
    the  error.) Note: After deleting the file, the next time you  run  the 
    program  it  will revert to the original default  conditions.  Use  the 
    Utilities  function  (discussed  in Section  2)  to  re-establish  your 
    preferences for various options.
     
                       Error reading configuration file
    If you installed QWIKMATH with an Advocate SET variable as  recommended 
    in Section 1, the program automatically saves certain values to a  file 
    named QWIKMATH.nnn (where "nnn" is a number) in your Advocate directory 
    each  time  you  exit  the program. That  file  has  become  corrupted. 
    QWIKMATH will revert to the original default values during its  current 
    use  and will attempt to create a valid replacement configuration  file 
    when you exit.

                            Can't install as TSR...
    This message is accompanied by one of three phrases:

          "Requires DOS 2.0  or higher" You have a very old version of your 
    operating  system which isn't compatible with TSR programs.  QWIKMATH's 
    TSR function will be inoperable until you upgrade your operating system 
    but will otherwise be fully functional.

          "No  free user interrupts" At the moment, all of  your  operating 
    system's user interrupt vectors (a technical subject) are being used by 
    other  programs. Remove any unneeded programs from memory, then  reload 
    QWIKMATH. If this doesn't help, shut down your computer as usual,  then 
    restart it with less TSRs or other programs in memory.

          "Unspecified  error" Your operating system refused to accept  the 
    request  to  install  QWIKMATH  as a TSR.  Ask  your  consultant  about 
    replacing the copy of your operating system from your back-up disks. Or 
    contact us with all available details. 

                         Program already loaded as TSR
    Follow  the  error-message  instructions to exit  the  second  copy  of 
    QWIKMATH and access the copy already in memory.

                      Path to Advocate directory too long
    You manually installed QWIKMATH and entered a SET command specifying an 
    Advocate  directory  PATH  longer  than  the  maximum  allowed  by  the 
    operating  system.  (This may have simply been  a  typographical  error 
    when editing your AUTOEXEC.BAT file.) Or, a later program corrupted the 
    "environment  variables" maintained in memory. First, try turning  your 
    computer  off  and on. If this doesn't help, either edit that  file  or 
    (better!)  reinstall this product from the original  distribution  copy 
    with  the supplied AHDINSTL program. If you still encounter a  problem, 
    some  other  program  probably  is corrupting  your  system.  Ask  your 
    computer  specialist to track down the errant program or (if this is  a 
    registered version) contact us as indicated in the last section.

            INTERNAL LOGIC ERROR: Invalid value for selected radix
    You've created a unique combination of conditions which has fooled  all 
    internal  validity checks except QWIKMATH's final,  "catch-all"  error-
    checking  algorithm.  As of this writing, you would  hold  the  dubious 
    honor  of being the first person to have done so among all  test  sites 
    and  other  users. We would be indebted if you report all  details,  in 
    particular:  the  Character  Mode, Storage Class  and  Current  Results 
    immediately  PRIOR to the errant operation; which operation  was  being 
    performed  when the error message appeared; the value being entered  at 
    that time; and most importantly which data-entry radix (decimal, octal, 
    etc.)  was last being used. If we can replicate and fix the  error,  we 
    will expeditiously forward the modified program to you with our sincere 
    appreciation.

                         Abnormal program termination
                                 Divide error
    The program encountered an unknown, fatal  error. Make a fresh copy  of 
    the  affected  program  from  your  original  disk  to  your   Advocate 
    directory,  then attempt to run the identical series of  commands  that 
    led  to  the error. If the problem repeats itself,  follow  your  usual 
    procedures  to  turn  off  your computer, restart  it  and  repeat  the 
    identical  series  of  commands.  In the  unlikely  event  the  problem 
    persists,  please  report full details to Advocate Enterprises  and  we 
    will  investigate.  If we determine the problem is in the  program,  we 
    will provide you with a revised copy at no charge. In the meantime, you 
    may  want  to consult your computer specialist or  repair  shop.  These 
    messages represent serious problems that almost surely aren't caused by 
    a  program  which has undergone the extensive testing we and  our  test 
    sites  have  conducted. More likely, the problem is a system  error  in 
    your  hardware or software. Your consultant should be able to  diagnose 
    such problems.

                                   [Various]
    Your operating system may report various problems (such as insufficient 
    memory  to  even start the program at the moment). See  your  operating 
    system  manual  or consultant for details of any  messages  not  listed 
    above.  If  not  found, contact us. (In exceptional  cases,  some  such 
    messages can even appear while a program is running.)
~ (Section 4)
                         << USER-ADDED INFORMATION >>

    Authorized  distributors  and registered end users may  add  notes  and 
    other  information for their purposes here. Begin by following a  basic 
    computer precaution of editing ONLY a back-up copy of this file. A word 
    processor  capable of ASCII output must be used. (For WordStar,  select 
    "Nondocument" rather than normal "Document" mode from its main menu  to 
    open your file. WordPerfect users: Open the file as usual, but save the 
    output file in "DOS" format. Others: See your word processor's manual.)

    IMPORTANT:   All text MUST remain below  "<< USER-ADDED INFORMATION >>" 
    and above the (undisplayed) "~ (Section 7)" to avoid potential  adverse 
    effects when this file is later executed with the HELP program.
~ (Section 5)
                 << LICENSE AGREEMENT, CREDITS & DISCLAIMER >>

    QWIKMATH.EXE,   QMHELP.EXE,   AEORDER.EXE,   AEORDER.HLP,   AEHELP.EXE, 
    AHDINSTL.COM and QWIKMATH.HLP and all accompanying materials  (together 
    referred to as "QWIKMATH" below) are copyright (c) 1986-90, J.W.  Olsen 
    /  Advocate  Enterprises,  Ltd.,  all  rights  reserved.  QMHELP  is  a 
    dedicated version of  QUICK HELP, copyright (c) 1986-89, J.W.  Olsen  / 
    Advocate   Enterprises,  Ltd., all rights reserved.   A   full-featured 
    version  is available for sale ($20 at this writing),  accompanied   by 
    instructions  to easily create unlimited help files on any  topics  for 
    use in your office or home with an ordinary word processor. 

    By  use   of  QWIKMATH,  user  agrees  to  all  terms   and  conditions 
    within this section, which constitute our full agreement.

    J.W. Olsen / Advocate Enterprises, Ltd. has taken due care in preparing 
    QWIKMATH.  However,  no  expressed or  implied  warranty  of  accuracy, 
    reliability or suitability for any specific purpose or use is  made. In 
    no event shall J.W. Olsen / Advocate Enterprises,  Ltd. be  liable  for  
    damages,  including  but not limited to incidental  or    consequential 
    damages,  connected  with  or  arising  from  furnishing,  performance, 
    support or use of QWIKMATH.

    Upon  payment of the registration licensing fee, J.W. Olsen /  Advocate 
    Enterprises,  Ltd.,  will  provide  the  latest  version  of  QWIKMATH, 
    telephone and modem access support, as well as notification of  certain 
    future updates and access to same for copying/mailing charges only ($10 
    as of this writing).

    You agree not to distribute any registered (as opposed to shareware  or 
    demo)    version   of   QWIKMATH  without   the   expressed,    written 
    permission of the  copyright holder.  Unregistered  users  may not  use 
    it  for  financial  gain,  and in any event may not  use  it  beyond  a 
    reasonable  period  sufficient to evaluate it without  registering  and 
    obtaining  an authorized license. Others may use it AT ONE SITE  or  BY 
    ONE INDIVIDUAL, but NOT BOTH, unless authorization to the contrary  has 
    been   expressly  provided  in  writing  by  J.W.  Olsen   /   Advocate 
    Enterprises,  Ltd. Subject to  the  other terms and  conditions,  users 
    are  authorized  to  make sufficient copies  of  registered  copies  of 
    QWIKMATH for normal use by the one individual or at the one site.

    Users who have received a complimentary copy of the registered QWIKMATH 
    version may not sell or otherwise transfer it to  another party.  Other 
    users  may  transfer  QWIKMATH (original disks  only, in  the  case  of 
    registered  copies)  to another party, provided  such  users  and  said 
    other party agree to all terms and conditions herein, and in all  cases 
    provided  all QWIKMATH materials are transferred together  and  without 
    alteration.  Further, by transfer of any copy of QWIKMATH,  the  former 
    licensee agrees to promptly relinquish any right to further possession, 
    use or ownership of said copy and all duplicates made from same.

    For  further  information  and order form  (including  bulk  rates  and 
    distributorships), see the accompanying AEORDER program, or contact:

                    J.W. OLSEN / ADVOCATE ENTERPRISES, LTD.
                           117 W. Harrison Building
                          6th Floor Mail Stop #A-408
                           Chicago, IL 60605  U.S.A.
                             312/939-3300  (voice)
                312/939-4411 (24-hr. modem telecommunications)


    Credits: 
    "QWIKMATH,  The Complete Programming Calculator," QUICK  HELP,  AEORDER 
    and  AEHELP are trademarks of J.W. Olsen / Advocate  Enterprises,  Ltd. 
    IBM  and  PC-DOS are registered trademarks  of  International  Business 
    Machines. MS-DOS is a registered trademark of Microsoft Corporation.
~
